home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbs_soft / sfsrv20.zip / SURVEY20.DOC < prev    next >
Text File  |  1993-03-21  |  46KB  |  1,215 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                  SFSURVEY version 2.0
  19.  
  20.  
  21.                          A survey conducting system for your
  22.                            SPITFIRE 3.3 questionnaire files
  23.  
  24.  
  25.  
  26.                                 copyright (C) 1992 by
  27.  
  28.                              // \// \
  29.                             <<  << T >ECH ONE
  30.                              \\//\\ / P.O. Box 701
  31.                               <<   >  Sioux Falls, SD  57101
  32.                                \\ /
  33.  
  34.  
  35.                                 Phone: (605) 361-3980
  36.                                  BBS: (605) 361-4666
  37.  
  38.         SFSurvey version 2.0                                       User Manual
  39.  
  40.  
  41.         SFSURVEY OVERVIEW
  42.         -----------------
  43.  
  44.         For  many years, surveys have often played major roles in helping  the
  45.         world  of  business  determine strategies for  success.  Surveys  have
  46.         helped  companies  determine marketing strategies,  manufacturers  set
  47.         production  priorities, caused companies to reconstruct sales  strate-
  48.         gies, and has even altered the course of political campaigns.  Surveys
  49.         provide vital information for predicting the outcome of events, uncov-
  50.         ering  areas for improvement, or showing the current status of a  par-
  51.         ticular situation.
  52.  
  53.         Have you ever considered using one of your SPITFIRE questionnaires for
  54.         conducting a survey of your users? As a SysOp, you know how  important
  55.         it is that your users get enjoyment out of using your BBS. After  all,
  56.         that  is  what  keeps them coming back. The problem is,  you  may  not
  57.         always  know  how well they enjoy your BBS, or what  their  likes  and
  58.         dislikes  are  unless they voluntarily leave suggestions  or  comments
  59.         through feedback.
  60.  
  61.         Users often have good ideas for improving a BBS, but unless you inten-
  62.         tionally  ask  them, they may not volunteer the  information.  If  you
  63.         posted a questionnaires to do an opinion survey of your BBS, you could
  64.         gather  the necessary information to help you determine what  kind  of
  65.         improvements you could make to your bulletin board.
  66.  
  67.         This  would help you collect the kind of information you  are  looking
  68.         for,  but  there is still one other problem. It would mean  a  lot  of
  69.         extra work for you. As the SysOp, you would have to wade through  your
  70.         SPITFIRE answer files and tally the information to get the end  result
  71.         that  you are really looking for. I wrote SFSURVEY to assist  in  this
  72.         effort.
  73.  
  74.         SFSURVEY  works  in conjunction with your SPITFIRE  questionnaires  to
  75.         generate  surveys for you. SFSURVEY will read the .QUE and  .REP  file
  76.         that you choose, collect & sort the information, and write the results
  77.         in an attractive report to an output file.
  78.  
  79.         If  you happen to be a hardware or software vendor, SFSURVEY can  con-
  80.         duct  product  surveys quite well. You can even conduct surveys  as  a
  81.         hobby  or as a service to your users. SFSURVEY works well  on  opinion
  82.         surveys, product surveys, consumer surveys, political surveys, or just
  83.         about any other reason you can come up with for conducting a survey.
  84.  
  85.  
  86.         SFSURVEY FEATURES
  87.         -----------------
  88.  
  89.         When  I  first created SFSURVEY, it was a bare bone utility  that  did
  90.         just enough to get the job done and that was it. Since I have  decided
  91.         to  release it to ShareWare and make it available to other  SysOps,  I
  92.         have  added some features to the program to make it as attractive  and
  93.         maintenance free as possible. Some of those features are:
  94.  
  95.         [*] SFSURVEY can run unattended (as an event for example). Running the
  96.             program  as  a weekly event will speed up program  operation.  The
  97.  
  98.                                         page 1
  99.  
  100.         SFSurvey version 2.0                                       User Manual
  101.  
  102.  
  103.             more new data there is in the answer file, the longer it takes the
  104.             program to sort the data. Sorting time is approximately 2  seconds
  105.             per user per question.
  106.  
  107.         [*] SFSURVEY  is completely safe  with your data files!  When SFSURVEY
  108.             opens your .QUE and .REP files, it opens them for input only,  and
  109.             does not do any writing to these files.
  110.  
  111.         [*] SFSURVEY can be configured to require a minimum number of partici-
  112.             pants,  or a deadline for the survey, or both. This  prevents  the
  113.             program  from  generating a survey before  enough  information  is
  114.             collected.
  115.  
  116.         [*] SFSURVEY will generate a SPITFIRE display file (.BBS/CLR) contain-
  117.             ing the outcome of your survey that you can use to display to your
  118.             users as a bulletin, welcome screen, etc. When conducting a survey
  119.             involving  your users, they will surely be interested in the  out-
  120.             come.  This gives you the option to automatically generate a  file
  121.             for them as soon as the survey is complete.
  122.  
  123.         [*] SFSURVEY maintains its own error log to report any errors  encoun-
  124.             tered  during operation, and sends only important messages in  the
  125.             HEYSYSOP.LOG file.
  126.  
  127.         [*] SFSURVEY will allow up to 99 questions for a single survey.
  128.  
  129.  
  130.         SYSTEM REQUIREMENTS
  131.         -------------------
  132.  
  133.         SFSURVEY  2.0 has been designed to run with SPITFIRE 3.3  BBS  system.
  134.         The minimum system requirements for running SFSURVEY are:
  135.  
  136.         - IBM XT, AT, or compatible
  137.         - 256K RAM (free)
  138.         - Hard Disk
  139.         - SPITFIRE 3.3 BBS Software
  140.         - FILES=20 (minimum) in your CONFIG.SYS file
  141.  
  142.         I  have not worked with any other types of BBS software, and I am  not
  143.         familiar with file structures from other systems. So for now, SPITFIRE
  144.         is the only system I know of that SFSURVEY will work with.
  145.  
  146.  
  147.         SFSURVEY FILES
  148.         --------------
  149.  
  150.         The files that make up the SFSURVEY system are listed below,
  151.         along with a description of their contents. Files marked with a
  152.         (*) are provided with SFSURVEY. All others are created by the
  153.         program during operation.
  154.  
  155.         * SFSURVEY.EXE: This is the program or executable file.
  156.  
  157.         * SFSURVEY.CFG:  This is the configuration file for SFSURVEY and  must
  158.                   reside in the same directory as SFSURVEY.EXE.
  159.  
  160.                                         page 2
  161.  
  162.         SFSurvey version 2.0                                       User Manual
  163.  
  164.  
  165.  
  166.         * SFSURVEY.DOC: The documentation (this file).
  167.  
  168.         * SFSURVEY.BAT:  Batch file containing commands to run SFSURVEY as  an
  169.                   event.
  170.  
  171.           SFSURVEY.ERR:  This is an error log maintained by SFSURVEY  in  it's
  172.                   home  directory for reporting errors during  program  opera-
  173.                   tion.  Once the error has been corrected, this file  can  be
  174.                   deleted as often as you choose.
  175.  
  176.         * SFORDER_.QUE:  This is a sample questionnaire file that is  actually
  177.                   provided  to serve two purposes. 1) To give you some  guide-
  178.                   lines on what a survey questionnaire should look like and 2)
  179.                   for  you to rename and use to conduct your first survey  and
  180.                   test  the program to see how well it works. You  can  modify
  181.                   this file as you see fit.
  182.  
  183.         SFORDER<x>.SRV  or  SFNEWU.SRV:  This is the output  file  written  by
  184.                   SFSURVEY with your survey results in it. This file is  writ-
  185.                   ten to the SFSURVEY home directory and is created by  SFSUR-
  186.                   VEY.EXE.  When this file is finally written, the  survey  is
  187.                   complete.
  188.  
  189.         SFORDER<x>.DTA or SFNEWU.DTA: This is a data file maintained by SFSUR-
  190.                   VEY  which  is  a sorted version of  the  original  SPITFIRE
  191.                   answer  file.  The  main purpose of this file  is  to  allow
  192.                   SFSURVEY  to perform it's sorting routines without  altering
  193.                   the original answer file. This file is written to the SFSUR-
  194.                   VEY  home directory and is not created until the first  time
  195.                   SFSURVEY.EXE is executed.
  196.  
  197.         * ORDER.FRM: This is an order form to be used to register SFSURVEY  or
  198.                   purchase another TECH ONE software product.
  199.  
  200.         * LICENSE.DOC:  This  is the license agreement that  comes  with  your
  201.                   registered version of SFSURVEY. If this file exists, print a
  202.                   copy on your printer and keep it in a safe place.
  203.  
  204.  
  205.         INSTALLATION
  206.         ------------
  207.  
  208.         Installing  & setting up SFSURVEY is quick and easy. Just  follow  the
  209.         steps below:
  210.  
  211.         1. Create a separate directory for SFSURVEY to run.
  212.  
  213.         2. Copy all the files into the directory you have chosen, and edit the
  214.            configuration file SFSURVEY.CFG to accommodate your situation.  The
  215.            two files that must be present for SFSURVEY to run are SFSURVEY.EXE
  216.            and SFSURVEY.CFG
  217.  
  218.         3. If you decide to run SFSURVEY as an event, modify your SF.BAT  file
  219.            to  include  the changes. Then enable the event  from  within  your
  220.            SPITFIRE system.
  221.  
  222.                                         page 3
  223.  
  224.         SFSurvey version 2.0                                       User Manual
  225.  
  226.  
  227.  
  228.         That's it! Now you're all set up. If you intend to set up SFSURVEY  as
  229.         an event, I recommend using the SFBUSY maintenance utility from Buffa-
  230.         lo Creek Software. If you did not get this utility with your  SPITFIRE
  231.         software, it can be downloaded from the Buffalo Creek BBS.
  232.  
  233.         The  changes in your SF.BAT file should look similar to the  following
  234.         example  (these lines can be found in SFSURVEY.BAT that came with  the
  235.         system). The sample shown is for Event A, but you can modify the lines
  236.         to use any event you choose.
  237.  
  238.  
  239.         :EVENT_A
  240.            REM Run SFSURVEY
  241.            SFBUSY C:\SF\WORK /S
  242.            IF ERRORLEVEL 2 GOTO EVENT_A
  243.            IF ERRORLEVEL 1 GOTO END_A
  244.            CD \SF\SURVEY
  245.            SFSURVEY
  246.            CD \SF
  247.            SFBUSY C:\SF\WORK /C
  248.            :END_A
  249.            GOTO LOOP
  250.  
  251.  
  252.         THE CONFIGURATION FILE
  253.         ----------------------
  254.  
  255.         The  configuration  file  (SFSURVEY.CFG) is a plain  ASCII  file  that
  256.         contains  information critical to the operation of SFSURVEY.  You  can
  257.         use  your favorite text editor to modify or create the file. The  file
  258.         should look similar to the following example (see the sample .CFG file
  259.         that came with the program).
  260.  
  261.         0                           ;Line 1
  262.         TECH ONE Support Line BBS   ;Line 2
  263.         Earl Buckelew               ;Line 3
  264.         C:\SF\WORK\                 ;Line 4
  265.         C:\SF\DISPLAY\              ;Line 5
  266.         SFORDERA                    ;Line 6
  267.         10                          ;Line 7
  268.         08-13-1991                  ;Line 8
  269.         BULLET6                     ;Line 9
  270.  
  271.         Now  let's look at the configuration file in detail. The  comments  to
  272.         the  right  shown in the illustration above (;Line 1...;Line  2,  etc)
  273.         should  not  be included in the SFSURVEY.CFG file. This was  done  for
  274.         labeling  purposes only. Also, the configuration file must have all  9
  275.         lines or an error will result. Here is an explanation of the  contents
  276.         of each line in the configuration file.
  277.  
  278.         Line 1: This line should contain your registration number. This number
  279.                 can be found at the top of the license agreement (LICENSE.DOC)
  280.                 that  came with SFSURVEY. Placing your registration number  on
  281.                 this line will eliminate the word UNREGISTERED from the top of
  282.                 the survey file created by the program. If you have not regis-
  283.  
  284.                                         page 4
  285.  
  286.         SFSurvey version 2.0                                       User Manual
  287.  
  288.  
  289.                 tered  SFSURVEY yet, you will not have a registration  number,
  290.                 but  this line must still exist, so enter 0 or leave  a  blank
  291.                 line.
  292.  
  293.         Line 2: This  line should contain the name of your BBS. This  name  is
  294.                 what SFSURVEY will be registered to and what your registration
  295.                 number will be based on, not the SysOps name.
  296.  
  297.         Line 3: This line contains the full name of the SysOp.
  298.  
  299.         Line 4: This  line should contain the drive and path of  the  SPITFIRE
  300.                 work  directory  (usually C:\SF\WORK\). Be sure this  path  is
  301.                 correct  because  this  is  where  SFSURVEY  will  search  for
  302.                 the .QUE, .REP and HEYSYSOP.LOG files.
  303.  
  304.         Line 5: This  line should contain the drive and path of  the  SPITFIRE
  305.                 display directory (usually C:\SF\DISPLAY\). This path is where
  306.                 the  ASCII and ANSI display files will be created if they  are
  307.                 specified.
  308.  
  309.         Line 6: This  line should contain the name of the  questionnaire  file
  310.                 being  surveyed. It can be either the new user  questionnaire,
  311.                 or one of the main questionnaires.
  312.  
  313.         Line 7: This  line should contain the minimum number  of  participants
  314.                 you wish to generate a survey for (min. 0, max. 32767). SFSUR-
  315.                 VEY will not produce a survey file until at least the  minimum
  316.                 number of participants have answered the questionnaire. If you
  317.                 do  not wish to specify a minimum number of  participants  for
  318.                 the  survey,  enter a 0. If you enter a number  less  than  0,
  319.                 SFSURVEY  will  assume 0. If you enter a  number  larger  than
  320.                 32767, an error will result, SFSURVEY will report the error in
  321.                 the SFSURVEY.ERR file, and terminate operation. This option is
  322.                 used  in conjunction with the DATE option below  to  determine
  323.                 when to generate a survey file.
  324.  
  325.         Line 8: This  line should contain the earliest date that you want  the
  326.                 survey file generated. This option is used in conjunction with
  327.                 the minimum participants option to determine when to  generate
  328.                 the  survey  file. SFSURVEY will not generate  a  survey  file
  329.                 until the last date it was executed is at or beyond this  date
  330.                 AND  the  minimum number of participants have been  met.  Both
  331.                 conditions  must  exist before the survey file  is  generated.
  332.                 This  way, you can impose a deadline for the questionnaire  to
  333.                 be  completed and still create a condition for minimum  number
  334.                 of participants. Once the survey file is generated, the survey
  335.                 is  considered  over. If you do not wish to  specify  a  date,
  336.                 enter  NONE  on this line. The date must be in the  format  of
  337.                 MM-DD-YYYY to be recognized as valid.
  338.  
  339.         Line 9: This line should contain the name of the ASCII & ANSI  display
  340.                 file,  if one is desired. This file could be used  to  display
  341.                 your  survey results to your users. If you specify  a  display
  342.                 file,  they will be created immediately after the survey  file
  343.                 is generated. If you do not wish a display file, enter NONE on
  344.                 this line.
  345.  
  346.                                         page 5
  347.  
  348.         SFSurvey version 2.0                                       User Manual
  349.  
  350.  
  351.  
  352.  
  353.         HOW IT WORKS
  354.         ------------
  355.  
  356.         If  you  are running SFSURVEY as an event, SPITFIRE will  execute  the
  357.         program  automatically.  Otherwise, SFSURVEY can be  invoked  manually
  358.         from  the  DOS prompt. You should always run SFSURVEY  from  it's  own
  359.         directory.  It  is advised NOT to run the program through a  DOS  PATH
  360.         from  a  directory  other than it's own. SFSURVEY  creates  &  deletes
  361.         temporary  files  that it uses when it is  performing  sort  routines.
  362.         These  files are created and deleted in the directory you are in  when
  363.         you invoke SFSURVEY, and running SFSURVEY from it's own directory will
  364.         insure safety.
  365.  
  366.         Once  a survey file has been generated, the survey is considered  over
  367.         and SFSURVEY will not do any more work on that questionnaire. At  this
  368.         point,  you  can print the survey file on your printer. You  can  then
  369.         start a new survey in the same directory by deleting all the files  in
  370.         that  directory except SFSURVEY.EXE and SFSURVEY.CFG. Don't forget  to
  371.         modify the configuration file to conform to the new survey.
  372.  
  373.         If you discover that the outcome of the survey does not contain enough
  374.         information to suit your needs, you can delete the survey (.SRV)  file
  375.         and modify the configuration file to prolong the survey. The next time
  376.         SFSURVEY runs, it will continue the survey as if it had never ended.
  377.  
  378.         I  know that there is not a gigantic demand for this type  of  utility
  379.         and  the applications are somewhat limited, but if you DO decide  some
  380.         day  to conduct an opinion survey, product survey, consumer survey  or
  381.         something  of that nature, you absolutely will NOT want to be  without
  382.         this utility.
  383.  
  384.  
  385.         QUESTIONNAIRE FORMAT
  386.         --------------------
  387.  
  388.         In  order for SFSURVEY to work properly with a SPITFIRE  questionnaire
  389.         and  produce  accurate results, you must follow a  few  simple  rules.
  390.         Sticking to these rules should not conflict with the normal  operation
  391.         of your BBS in any way.
  392.  
  393.         1.  The  questionnaire being used for the survey requires  a  specific
  394.         format.  All  questions in the survey questionnaire must  be  numbered
  395.         with the following syntax...
  396.  
  397.         [#1]
  398.         This is a sample question for this survey.
  399.  
  400.         ?Can you read this question.
  401.         +
  402.         +
  403.         -
  404.         -
  405.  
  406.  
  407.  
  408.                                         page 6
  409.  
  410.         SFSurvey version 2.0                                       User Manual
  411.  
  412.  
  413.         The  question should be numbered with the question number enclosed  in
  414.         square brackets "[]", and preceded by a number symbol "#". This  ques-
  415.         tion number should be on a line by itself. This is how SFSURVEY deter-
  416.         mines where a question in the questionnaire file begins. The last line
  417.         of  the question must be the line that contains the symbol that  tells
  418.         SPITFIRE  to prompt for an answer, and must be one of the following  4
  419.         symbols (see your SPITFIRE manual).
  420.  
  421.                                     :   @   #   ?
  422.  
  423.         These  are  the only questions SFSURVEY will check for.  This  is  how
  424.         SFSURVEY determines the end of a question. The text between the  ques-
  425.         tion  number and the symbol will eventually be written to  the  survey
  426.         file.  The output in the survey file for the above example might  look
  427.         like this:
  428.  
  429.         [#1]
  430.         This is a sample question for this survey.
  431.  
  432.         Can you read this question?
  433.  
  434.            54 said Yes  (96%)
  435.             2 said No   (4%)
  436.  
  437.         You  can place any kind of text between questions that is  allowed  in
  438.         any  other  SPITFIRE questionnaire, but all questions  in  the  survey
  439.         questionnaire  must begin with a question number and end with a  SPIT-
  440.         FIRE  questionnaire symbol. If SFSURVEY encounters one of the above  4
  441.         questionnaire  symbols  without first finding a question  number,  the
  442.         question  will be ignored and will not be included in the  survey.  If
  443.         SFSURVEY encounters a question number without ever finding a  SPITFIRE
  444.         questionnaire  symbol, an 'Input past end of file' will be written  to
  445.         the SFSURVEY.ERR log.
  446.  
  447.         2.  Do  not use Yes/No questions to branch to different parts  of  the
  448.         questionnaire.  This will cause the answers in the answer file  to  be
  449.         out  of  order  and they won't match up to the  proper  question.  All
  450.         Yes/No questions should be followed IMMEDIATELY by two plus signs  (+)
  451.         and  two  minus signs (-) like the example in #1  (see  your  SPITFIRE
  452.         manual). If your questionnaire contains any branching, the survey will
  453.         be inaccurate and may cause an error to be written to the SFSURVEY.ERR
  454.         log.
  455.  
  456.         3.  Do  not modify the questionnaire once the survey  is  in  progress
  457.         (e.g.  rearrange,  change, add, or delete questions).  This  may  also
  458.         cause the answers to be aligned with the wrong question. If you modify
  459.         the  questionnaire once the survey starts, the program may still  work
  460.         but  the survey will be inaccurate and it could cause an error  to  be
  461.         written  to the SFSURVEY.ERR log, and the results in your output  file
  462.         will be inaccurate.
  463.  
  464.         4.  The  questionnaire file is limited to 99 questions.  Any  and  all
  465.         questions  beyond 99 will be ignored and will not be included  in  the
  466.         survey.
  467.  
  468.  
  469.  
  470.                                         page 7
  471.  
  472.         SFSurvey version 2.0                                       User Manual
  473.  
  474.  
  475.         OPERATING GUIDELINES
  476.         --------------------
  477.  
  478.         With all the options that SPITFIRE allows regarding questionnaires, it
  479.         was  difficult  to  accommodate all the situations  that  a  practical
  480.         survey  would entail. Although I have not thoroughly  tested  SFSURVEY
  481.         before  releasing it as ShareWare, I think I covered  most  situations
  482.         that  would  be considered practical. Therefore, if you run  into  any
  483.         problems  using SFSURVEY or wish to offer suggestions for  improvement
  484.         or enhancement, please contact TECH ONE.
  485.  
  486.         I have also discovered (through testing and trial & error) that  there
  487.         are certain guidelines I should follow to get the best and most  accu-
  488.         rate results from the output of this program.
  489.  
  490.         1. Create a separate directory to install and run SFSURVEY instead  of
  491.            running  it from your SPITFIRE system directory. SFSURVEY will  use
  492.            it's  home directory to write the output files to. It also  creates
  493.            and deletes temporary files that it works with during the  calcula-
  494.            tion  processes.  This will keep the program from  cluttering  your
  495.            SPITFIRE  system  directory.  I  would  recommend  something   like
  496.            C:\SURVEY\ or C:\SF\SURVEY\
  497.  
  498.         2. For  an  accurate survey, I recommend that you set  up  the  survey
  499.            questionnaire  so  that it can only be answered once by  each  user
  500.            (see  your SPITFIRE manual). Otherwise, your survey could have  the
  501.            same participant more than once and cause the final survey to  have
  502.            inaccurate results.
  503.  
  504.         3. The  program  works best with Yes/No questions, but it  will  total
  505.            other  types  of questions as well. Unless it is critical  to  your
  506.            survey,  try  to  stay away from questions that  prompt  for  phone
  507.            numbers  or dates, because 99% of your users will each have a  dif-
  508.            ferent answer for this type of question.
  509.  
  510.         4. SFSURVEY  was  designed to work with only one  questionnaire  at  a
  511.            time. However, if you wish to conduct a survey on two or more ques-
  512.            tionnaires  at the same time, you can simply install SFSURVEY  into
  513.            different directories. For example, if you wish to conduct a survey
  514.            on both SFORDERA.QUE and SFORDERD.QUE at the same time, just create
  515.            two different directories to copy SFSURVEY to (e.g.  C:\SF\SURVEY1\
  516.            and  C:\SF\SURVEY2\). You can copy SFSURVEY into as many  different
  517.            directories as you like and then specify a different  questionnaire
  518.            in each configuration file.
  519.  
  520.  
  521.         SHAREWARE NOTICE
  522.         ----------------
  523.  
  524.         The  evaluation  copy of this program has been released to the  public
  525.         as shareware. Under the Shareware concept, you are allowed and encour-
  526.         aged to freely copy, distribute, and/or share the program with others,
  527.         as  long  as the entire package remains in  it's  original  unmodified
  528.         state.
  529.  
  530.         The only difference between Shareware and the commercial software  you
  531.  
  532.                                         page 8
  533.  
  534.         SFSurvey version 2.0                                       User Manual
  535.  
  536.  
  537.         buy off the shelf is that the cost of things like advertising, market-
  538.         ing,  packaging,  etc. have been eliminated from the  Shareware.  This
  539.         allows the author to offer the software to the user for usually a much
  540.         lower price than the comparable package off the shelf.
  541.  
  542.         Unlike public domain, Shareware is copyrighted, and the free distribu-
  543.         tion  allows you to "Try Before You Buy".  However, free  distribution
  544.         does  NOT mean that a program can be used regularly  without  payment.
  545.         If you try it, like it, and decide to use the software regularly,  you
  546.         should register your copy with the author.
  547.  
  548.                                     Why Register?
  549.  
  550.         One good reason to register is that you normally receive benefits that
  551.         do  not come with the unregistered copy. Depending on the author,  you
  552.         may  receive the latest version of the software, printed  manual,  up-
  553.         dates, user support, etc.
  554.  
  555.         But the most important reason of all is that since shareware is  copy-
  556.         righted software, your use is subject to the limitations and  restric-
  557.         tions  of  the  copyright laws. Normally, authors  will  modify  their
  558.         copyright protection for your use of the software.
  559.  
  560.         COPYRIGHT NOTICE
  561.         ----------------
  562.  
  563.         This software is copyrighted and all rights are reserved by TECH  ONE.
  564.         Your  use is subject to the limitations and restrictions of the  copy-
  565.         right  laws. If you are running an evaluation copy, we  hereby  modify
  566.         our copyright protection for your use of the software as follows:
  567.  
  568.         YOU MAY...
  569.  
  570.          ...Use the software as required to gain a complete evaluation of it's
  571.         capabilities to determine if it suits your requirements.
  572.  
  573.          ...Copy the software in it's entire, unmodified state for the purpose
  574.         of  distribution,  and charge a nominal fee for the  copying  service,
  575.         disk and/or shipping & handling.
  576.  
  577.          ...Archive  the system for electronic file transfer  (uploading/down-
  578.         loading)
  579.  
  580.         YOU MAY NOT...
  581.  
  582.          ...Modify  any part of the source code or documentation  without  the
  583.         expressed, written consent of TECH ONE.
  584.  
  585.          ...Sell,  or  offer  for sale, this program,  documentation,  or  any
  586.         output from this program without the expressed written consent of TECH
  587.         ONE.
  588.  
  589.          ...Willfully continue to use this software as a regular part of  your
  590.         library without paying the registration fee and becoming a  registered
  591.         owner.
  592.  
  593.  
  594.                                         page 9
  595.  
  596.         SFSurvey version 2.0                                       User Manual
  597.  
  598.  
  599.         IMPORTANT NOTE: The license agreement you receive with the  registered
  600.         version overrides the above waiver. It should also be pointed out that
  601.         all  the  materials you receive after becoming a registered  owner  is
  602.         copyrighted material and NONE of it is considered shareware.
  603.  
  604.  
  605.         REGISTRATION
  606.         ------------
  607.  
  608.         In  order to get the benefits of a registered user, you must  complete
  609.         the order form in this manual and return it to us. Upon receiving your
  610.         order, we will assign you a registration number. Please refer to  this
  611.         number  with  any correspondence to TECH ONE regarding  this  program.
  612.         Before  getting into the details of registration, there  is  something
  613.         you need to know about us.
  614.  
  615.                                       Our Policy
  616.  
  617.         Our policy at TECH ONE is to provide TRUE shareware. We believe in the
  618.         policy behind the shareware concept. We also believe that most  people
  619.         that use these products are basically honest, and will be glad to  pay
  620.         the registration fee for any software they find useful.
  621.  
  622.         Therefore, none of our shareware programs are so called "crippled"  in
  623.         any way. The registered version functions the same as the unregistered
  624.         version. The only differences between the unregistered version and the
  625.         registered version in any of our titles is:
  626.  
  627.         1.   The  registration benefits apply only to the registered  version.
  628.              As  a registered user of any TECH ONE software product, you  will
  629.              receive:
  630.  
  631.              - The latest version of the software.
  632.              - Notification of updates offered at a 40% discount.
  633.              - Free updates on errors or fixes.
  634.              * User support via our Support Line BBS at 605-361-4666.
  635.  
  636.              * You will have an unlimited access to the TECH ONE Support  Line
  637.              BBS  where you can receive user support on any software title  we
  638.              sell. More information will be available to you when you log on.
  639.  
  640.         2.   A  registration screen might appear in the unregistered  version.
  641.              Upon registration, this screen would be removed.
  642.  
  643.         3.   If  our  program produces an output file, the  word  UNREGISTERED
  644.              might appear in this file with the unregistered version.
  645.  
  646.         To receive the registered version of this program, print and  complete
  647.         the  order form at the back of this manual and mail it along with  the
  648.         appropriate payment to:
  649.  
  650.                              // \// \
  651.                             <<  << T >ECH ONE
  652.                              \\//\\ / P.O. Box 701
  653.                               <<   >  Sioux Falls, SD  57101
  654.                                \\ /
  655.  
  656.                                         page 10
  657.  
  658.         SFSurvey version 2.0                                       User Manual
  659.  
  660.  
  661.  
  662.         DISCLAIMER
  663.         ----------
  664.  
  665.         This software package is provided on an 'as is' basis and includes  no
  666.         warranties,  expressed or implied. In no event shall TECH ONE be  held
  667.         liable  for any direct, indirect, incidental or consequential  damages
  668.         or loss resulting from any defect in, or output from the software. The
  669.         user  bears  the entire risk of it's quality and performance  for  any
  670.         given application.
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.                                         page 11
  719.  
  720.         SFSurvey version 2.0                                       User Manual
  721.  
  722.  
  723.                                       Appendix A
  724.                                    SFSURVEY Errors
  725.  
  726.         SFSURVEY was written with a built in error reporting system to  report
  727.         any errors that might occur. Here is a partial list of the errors that
  728.         SFSURVEY  will report on, along with the probable cause  and  possible
  729.         solution.  When  errors are encountered they will be  written  to  the
  730.         SFSURVEY.ERR  file.  If SFSURVEY reports any other errors, or  if  you
  731.         encounter  an error you cannot remedy, or discover a bug in  the  pro-
  732.         gram, please contact TECH ONE.
  733.  
  734.  
  735.         Error: {filename} not a SPITFIRE questionnaire
  736.  
  737.         Cause: The  questionnaire specified in the SFSURVEY.CFG file is not  a
  738.                SPITFIRE questionnaire (does not end with .QUE).
  739.  
  740.         Solution: The questionnaire file you specify must be a .QUE file. Edit
  741.                the configuration file and correct the error.
  742.  
  743.  
  744.         Error: {filename} not a SPITFIRE answer file
  745.  
  746.         Cause: The answer file specified in the SFSURVEY.CFG is not a SPITFIRE
  747.                answer file (does not end with .REP)
  748.  
  749.         Solution:  This file must be a .REP file. Edit the configuration  file
  750.                and correct the error.
  751.  
  752.  
  753.         Error: Too many participants in SFSURVEY.CFG
  754.  
  755.         Cause: This  occurs  when the minimum number of  participants  in  the
  756.                SFSURVEY.CFG file is too large (over 32767).
  757.  
  758.         Solution: Check the configuration file and make the necessary  adjust-
  759.                ment.
  760.  
  761.  
  762.         Error: {filename} not found
  763.  
  764.         Cause: You  have  either  specified  a  path  or  a  filename  in  the
  765.                SFSURVEY.CFG file that could not be found or does not exist  or
  766.                the  SFSURVEY.CFG  file could not be found. This  can  also  be
  767.                caused simply by no answer file being available yet.
  768.  
  769.         Solution: Check the configuration file to make sure all path names and
  770.                file   names   are  spelled  correctly.  Also  be   sure   that
  771.                SFSURVEY.CFG is in the same directory as SFSURVEY.EXE.
  772.  
  773.         Error: Bad file name or number on {filename}
  774.  
  775.         Cause: Either one of the file names specified in the SFSURVEY.CFG file
  776.                contains  an invalid character, or there is a bug in  the  pro-
  777.                gram.
  778.  
  779.  
  780.                                         page 12
  781.  
  782.         SFSurvey version 2.0                                       User Manual
  783.  
  784.  
  785.         Solution: Check the spelling of your path names and file names in  the
  786.                configuration  file and correct any errors. All path names  and
  787.                file  names  in the SFSURVEY.CFG must conform to  standard  DOS
  788.                format.
  789.  
  790.  
  791.         Error: Too many open files
  792.  
  793.         Cause: The  limit of the number of open files your system  will  allow
  794.                has been exceeded.
  795.  
  796.         Solution:  Check  your CONFIG.SYS file to be sure your  FILES  command
  797.                specifies  at least 20 files. If the error continues,  increase
  798.                this to something more than 20.
  799.  
  800.  
  801.         Error: Path/file access error
  802.  
  803.         Cause: One  of  the  path  names  or  file  names  specified  in   the
  804.                SFSURVEY.CFG file could not be accessed.
  805.  
  806.         Solution:  Check your configuration file and make sure all path  names
  807.                and file names are spelled correctly.
  808.  
  809.  
  810.         Error: Path not found
  811.  
  812.         Cause: One of the path names specified in the SFSURVEY.CFG file  could
  813.                not be found.
  814.  
  815.         Solution:  Check the spelling of the path names in  the  configuration
  816.                file and correct any errors.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.                                         page 13
  843.  
  844.         SFSurvey version 2.0                                       User Manual
  845.  
  846.  
  847.                                       Appendix B
  848.                                   SFSURVEY messages
  849.  
  850.         Here  is a list of messages that could be written to the  HEYSYSOP.LOG
  851.         file during the course of program operation. Variables in the  message
  852.         syntax are defined below.
  853.  
  854.              {quefile}    - The questionnaire file being surveyed.
  855.              {ansfile}    - The corresponding answer file.
  856.              {surveyfile} - The survey file
  857.              {asciifile}  - The ASCII display file
  858.              {ansifile}   - The ANSI display file
  859.              {monthfile}  - The files containing data preserved during purge.
  860.  
  861.  
  862.         Error log SFSURVEY.ERR updated!! Please check this file!!
  863.  
  864.              SFSURVEY sends this message whenever it reports an error in the
  865.              error log, prompting you to check the file and correct the error.
  866.  
  867.  
  868.         Survey on {quefile} complete on MM-DD-YYYY at HH:MM:SS!
  869.            {asciifile} display file created!
  870.            {ansifile} display file created!
  871.  
  872.              This message is written upon the completion of the survey, indi-
  873.              cating to you that the survey is over. If any display files are
  874.              specified, they will be reported also.
  875.  
  876.  
  877.         Not enough participants to create survey for {quefile}.
  878.            [xxx] participants out of [yyy] minimum.
  879.  
  880.              This message is written only when the configured deadline has
  881.              been met or exceeded, and the minimum number of participants has
  882.              not been met. [xxx] will reflect the current number of partici-
  883.              pants, and [yyy] will reflect the minimum set in your configura-
  884.              tion. This lets you know that your survey deadline has been met,
  885.              but you are still waiting on enough users to participate.
  886.  
  887.  
  888.         Too soon to create survey for {quefile}
  889.            Deadline is MM-DD-YYYY.
  890.  
  891.              This message is written only when the requirement for minimum
  892.              number of participants has been met, and the deadline in the DATE
  893.              option has not been satisfied. MM-DD-YYYY will reflect the dead-
  894.              line you have specified in your configuration file. This lets you
  895.              know that you have enough participants to generate the survey,
  896.              but you are waiting on your deadline.
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.                                         page 14
  905.  
  906.         SFSurvey version 2.0                                       User Manual
  907.  
  908.  
  909.         Survey for {quefile} already complete!
  910.  
  911.              This message is written when the survey file has been completed
  912.              and the program is still expected to work on the survey. Once a
  913.              survey has been completed, the survey is over and SFSURVEY will
  914.              not work on the survey anymore.
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.                                         page 15
  967.  
  968.         SFSurvey version 2.0                                       User Manual
  969.  
  970.  
  971.                                       Appendix C
  972.                                   Sample Survey File
  973.  
  974.         ======================================================================
  975.         The  following survey was compiled on 08-13-1992 at 20:08:27  by  TECH
  976.         ONE Support Line BBS using SFSURVEY v2.0. #UNREGISTERED
  977.  
  978.                                    Survey on SFORDERA.QUE
  979.  
  980.         We thank the following 15 user(s) for participating in our survey.
  981.  
  982.            Terry Hanten                            Tom Janke
  983.            Marty Westra                            Jeff Westra
  984.            Don Tripp                               Judy Tripp
  985.            Bruce Sinkler                           George Newell
  986.            Donna Shierk                            Richard Bartlett
  987.            Kelly Lippert                           Leroy Kluin
  988.            Dave Flynn                              Jan Stoffers
  989.            Jim Halverson
  990.  
  991.         [#1]
  992.         Are you a local caller?
  993.  
  994.               6 said NO  ( 40 %)
  995.               9 said YES  ( 60 %)
  996.  
  997.         [#2]
  998.         Do you use a separate phone line for telecommunications?
  999.  
  1000.               13 said NO  ( 86 %)
  1001.               2 said YES  ( 13 %)
  1002.  
  1003.         [#3]
  1004.         Do you own more than one computer?
  1005.  
  1006.               10 said NO  ( 66 %)
  1007.               5 said YES  ( 33 %)
  1008.  
  1009.         [#4]
  1010.         Enter the manufacturer of the computer you are using now.
  1011.  
  1012.               1 said ZIDEX  ( 6 %)
  1013.               5 said EPSON  ( 33 %)
  1014.               2 said IBM  ( 13 %)
  1015.               1 said PANASONIC  ( 6 %)
  1016.               1 said MAGNAVOX  ( 6 %)
  1017.               1 said COMMODORE  ( 6 %)
  1018.               2 said GATEWAY  ( 13 %)
  1019.               1 said GOLDSTAR  ( 6 %)
  1020.               1 said PACKARD BELL  ( 6 %)
  1021.  
  1022.         [#5]
  1023.         What percentage of your time do you spend in the message area?
  1024.         (enter a number only with no percent sign).
  1025.  
  1026.               1 said 10  ( 6 %)
  1027.  
  1028.                                         page 16
  1029.  
  1030.         SFSurvey version 2.0                                       User Manual
  1031.  
  1032.  
  1033.               3 said 20  ( 20 %)
  1034.               1 said 25  ( 6 %)
  1035.               5 said 30  ( 33 %)
  1036.               3 said 40  ( 20 %)
  1037.               1 said 50  ( 6 %)
  1038.               1 said 60  ( 6 %)
  1039.  
  1040.         [#6]
  1041.         What percentage of your time do you spend in the file area?
  1042.         (enter a number only with no percent sign).
  1043.  
  1044.               1 said 10  ( 6 %)
  1045.               8 said 20  ( 53 %)
  1046.               1 said 25  ( 6 %)
  1047.               1 said 30  ( 6 %)
  1048.               3 said 50  ( 20 %)
  1049.               1 said 60  ( 6 %)
  1050.  
  1051.         [#7]
  1052.         What percentage of your time do you spend in the doors section?
  1053.         (enter a number only with no percent sign)
  1054.  
  1055.               2 said 0  ( 13 %)
  1056.               1 said 10  ( 6 %)
  1057.               2 said 20  ( 13 %)
  1058.               1 said 25  ( 6 %)
  1059.               2 said 30  ( 13 %)
  1060.               1 said 35  ( 6 %)
  1061.               3 said 40  ( 20 %)
  1062.               1 said 45  ( 6 %)
  1063.               2 said 50  ( 13 %)
  1064.  
  1065.         [#8]
  1066.         How often do you read the main bulletins?
  1067.         (enter 1=never, 2=seldom, 3=often, 4=always)
  1068.  
  1069.               5 said 2  ( 33 %)
  1070.               9 said 3  ( 60 %)
  1071.               1 said 4  ( 6 %)
  1072.  
  1073.         [#9]
  1074.         Do you do any of your own programming?
  1075.  
  1076.               3 said YES  ( 20 %)
  1077.               12 said NO  ( 80 %)
  1078.  
  1079.         [#10]
  1080.         Have you ever written a SPITFIRE utility?
  1081.  
  1082.               15 said NO  ( 100 %)
  1083.         ======================================================================
  1084.                                  ** end of survey **
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.                                         page 17
  1091.  
  1092.         SFSurvey version 2.0                                       User Manual
  1093.  
  1094.  
  1095.                                SFSURVEY Version History
  1096.  
  1097.         version 1.0 - 09/13/92
  1098.  
  1099.              Initial Release
  1100.  
  1101.         version 2.0 - 03/20/93
  1102.  
  1103.              1.  SFSURVEY  was  modified  to  read  the  new  format  of   the
  1104.              SPITFIRE .REP file instead of the previous .ANS format.
  1105.  
  1106.              2. The configuration file SFSURVEY.CFG now only requires the name
  1107.              of the display file without the extension. The program  automati-
  1108.              cally adds the .BBS & .CLR extensions and generates both  display
  1109.              files.
  1110.  
  1111.              3. The configuration file SFSURVEY.CFG now only requires the name
  1112.              of  the  questionnaire file without the  extension.  The  program
  1113.              automatically  adds the .QUE & .REP extensions when working  with
  1114.              these files.
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.                                         page 18
  1153.  
  1154.         SFSurvey version 2.0                                       User Manual
  1155.  
  1156.  
  1157.  
  1158.                                       ORDER FORM
  1159.                                      ============
  1160.  
  1161.               // \// \
  1162.              <<  << T >ECH ONE                             Phone: 605-361-3980
  1163.               \\//\\ / P.O. Box 701                          BBS: 605-361-4666
  1164.                <<   >  Sioux Falls, SD  57101
  1165.                 \\ /
  1166.  
  1167.  
  1168.         Name: ________________________________________________________________
  1169.                                 (please print clearly)
  1170.  
  1171.         Address: _____________________________________________________________
  1172.  
  1173.         City: __________________________  State: ________  Zip: ______________
  1174.  
  1175.         ======================================================================
  1176.                     Please indicate your registration number below
  1177.                               if purchasing an upgrade.
  1178.  
  1179.                              [__________________________]
  1180.  
  1181.         ======================================================================
  1182.         Check here
  1183.  
  1184.         [  ]  SFSURVEY survey conducting software  ($10.00) ....... __________
  1185.               (for SPITFIRE questionnaires)        (upgrade $6.00)
  1186.  
  1187.         [  ]  The SPREAD pro football prediction   ($30.00) ....... __________
  1188.               system.                              (upgrade $18.00)
  1189.  
  1190.         [  ]  STRIPIT file conversion utility      ($ 5.00) ....... __________
  1191.                                                    (upgrade $3.00)
  1192.  
  1193.                                                       Sub Total ...$__________
  1194.  
  1195.                         South Dakota residents add 6% sales tax ... __________
  1196.  
  1197.         Shipping & Handling ...................... ($ 1.00) ....... __________
  1198.  
  1199.                                              Total enclosed .......$__________
  1200.  
  1201.          ------------------------------------------------------------------
  1202.         |        Payment method:     [ ] Check       [ ] Money Order        |
  1203.         |-------------------------------------------------------------------|
  1204.         | Type of media required:    [ ] 5 1/4       [ ] 3 1/2              |
  1205.          -------------------------------------------------------------------
  1206.  
  1207.         ----------------------------------------------------------------------
  1208.                    Make checks or money orders payable to TECH ONE.
  1209.                    Thank you for supporting the ShareWare concept!
  1210.  
  1211.  
  1212.  
  1213.  
  1214.                                         page 19
  1215.